Skip to content

[DOCS-13678] Rename "workload selection" to "instrumentation rules" across SSI docs#35448

Merged
domalessi merged 8 commits intomasterfrom
dominique.alessi/DOCS-13678-ssi-terminology-updates
Mar 24, 2026
Merged

[DOCS-13678] Rename "workload selection" to "instrumentation rules" across SSI docs#35448
domalessi merged 8 commits intomasterfrom
dominique.alessi/DOCS-13678-ssi-terminology-updates

Conversation

@domalessi
Copy link
Contributor

@domalessi domalessi commented Mar 20, 2026

What does this PR do? What is the motivation?

Fixes DOCS-13678

Renames the "workload selection" feature terminology to "instrumentation rules" across the APM Single Step Instrumentation docs. Also updates the injectors.md understanding guide to reflect the new CSI driver mechanism for library mounting in Kubernetes.

Files changed:

  • content/en/tracing/trace_collection/single-step-apm/kubernetes.md
  • content/en/tracing/trace_collection/single-step-apm/linux.md
  • content/en/tracing/trace_collection/single-step-apm/troubleshooting.md
  • content/en/tracing/guide/injectors.md

Terminology approach:

  • General usage: "workload selection" → "instrumentation rules"
  • Kubernetes-specific: preserved the noun "workloads" where it has a specific Kubernetes meaning (e.g., "Use instrumentation rules to target specific workloads")

Open questions

  • Linux UI label (linux.md, step 1): The navigation path currently reads APM > Service Setup > Workload Selection. Needs PM confirmation — is the UI menu item being renamed to "Instrumentation Rules", or does it remain "Workload Selection"? Holding on this change until confirmed. The screenshot (workload_selection_landing.png) and its alt text will also need updating when the UI is renamed.

  • CSI driver in injectors.md: The Kubernetes section now reads "Use the Datadog CSI driver to mount the injector and tracer libraries" (replacing the init containers reference). Engineering confirmed this specific line should change, but the adjacent bullet "Mount volumes to persist injected libraries" may also be outdated given the CSI driver mechanism. Needs engineer confirmation on whether that bullet should be updated or removed.

Merge instructions

Merge readiness:

  • Ready for merge

Additional notes

PR is in draft pending resolution of the open questions above.

Made with Cursor

domalessi and others added 2 commits March 20, 2026 16:10
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…s SSI docs

Also updates injectors.md to reflect new CSI driver mechanism.

Made-with: Cursor
@github-actions github-actions bot added the Guide Content impacting a guide label Mar 20, 2026
domalessi and others added 4 commits March 24, 2026 12:00
… pages

- Create layouts/shortcodes/ssi-products.html with a table of all products
  and configuration variables that can be enabled via SSI
- Replace placeholder "these include..." text on linux, docker, kubernetes,
  and windows SSI pages with the new shortcode
- Fix ddTraceConfigs link in kubernetes.md (was pointing to UST docs;
  now links to the supported products section and library config reference)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
… github.com:DataDog/documentation into dominique.alessi/DOCS-13678-ssi-terminology-updates
…update UI nav and attributes

- Rename "workload selection" → "instrumentation rules" throughout
- Update UI navigation path to APM > Software Catalog > Settings > Manage Instrumentation Rules
- Update attributes table: rename existing attributes to match current UI labels
  and add Operating System and Working Directory

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@domalessi domalessi marked this pull request as ready for review March 24, 2026 17:25
@domalessi domalessi requested a review from a team as a code owner March 24, 2026 17:25
Copy link
Contributor

@OliviaShoup OliviaShoup left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚀

@domalessi domalessi merged commit 7d45850 into master Mar 24, 2026
20 of 21 checks passed
@domalessi domalessi deleted the dominique.alessi/DOCS-13678-ssi-terminology-updates branch March 24, 2026 19:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Guide Content impacting a guide

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants